
******************************************************************************

Paris XP Driver Package 
Version 3.03 (Beta 3)
July 30, 2002

******************************************************************************

This document explains how to update your Paris 2.x or 3.x installation to
support Microsoft Windows 2000 or Microsoft Windows XP.

Table of Contents:
------------------
A. Installation Instructions
B. Known Issues
C. Common Error Messages
D. Support
E. Frequently Asked Questions
F. File Manifest and Versions
G. Manual Installation Instructions
H. Credits and Acknowledgements

******************************************************************************

A. Installation Instructions
----------------------------

1) Install and connect your Paris hardware on your PC with Windows 2000 or
   Windows XP installed.  Follow the hardware installation instructions that 
   came with your Paris system.

2) Install the new Paris hardware drivers for Windows 2000 and Windows XP: 

   -  Extract the Paris driver .ZIP file to a temporary folder.  On Windows 
      XP, you can accomplish this by right-clicking the .ZIP file and 
      choosing the "Extract All..." option.  On Windows 2000, you will need
      to use a zip file program (such as WinZip) to extract the 
      installation files.

   -  Run the SETUP.EXE application and follow the install wizard 
      instructions.  You may be given a warning during installation that the 
      driver is not digitally signed or that it has not passed Windows Logo 
      testing.  If so, click the "Continue Anyway" button to continue 
      installation of the driver.

   -  Once the wizard has completed, you will be prompted to restart your 
      computer.  You may either do this now or wait until you have finished 
      the rest of these installation instructions.

3) If you plan on installing Paris 3.0, you will need to update the PACE
   InterLok drivers before installing the Paris 3.0 software.  The latest
   version of these drivers is available on the Internet at:
   http://www.paceap.com/dldrvr.html

   The last version of the InterLok drivers used for testing the new Paris
   drivers is v.3.0.7.840, although any subsequent version will likely 
   work.

4) Install the Paris software (version 2.x or 3.x) using the installation 
   instructions that came with your Paris system.  

   Paris software and documentation is available for download from E-mu at:
   http://www.emu.com/products/paris/support/softwareDL.html

   NOTE: The new Paris drivers have been tested with Paris versions 2.11, 2.2, 
   and 3.0.  Earlier versions of the Paris software may not work properly with 
   the new drivers and are not recommended.

5) If you haven't done so already, you must reboot your computer to complete
   the installation of the Paris software and drivers.  Once your computer has
   restarted, you are ready to use Paris on your Windows 2000 or XP system!

******************************************************************************

B. Known Issues
---------------

Fixes for the following known problems are currently being investigated for
the next release of the driver:

-  Paris occasionally crashes with an exception during startup after the
   splash screen has closed, but before the main screen is fully loaded.  
   This occurs when you launch Paris directly and when you launch Paris by
   double-clicking an existing Paris project file (.PPJ).  Since this was 
   also a problem on Windows 98/ME with the old drivers, it's not clear 
   whether this is a fixable bug.

-  The MEC inventory does not always come back completely for MECs with
   3 or more MEC expansion cards installed.  The exact MEC inventory 
   returned seems to remain fairly consistent (i.e. the same MEC expansion 
   cards are always returned).

-  Not all attached C16s are reliably detected upon startup.

-  Not all attached 442s are reliably detected upon startup.

-  Paris occasionally crashes with an exception while shutting down Paris.
   The main side effect of this is that any configuaration changes (ex. I/O 
   and disk cache sizes) you made inside Paris will be lost.  Changes made
   to a .PPJ should be saved correctly, however.  If you are suffering from
   crashes on most shutdowns, then you should make configuration changes 
   directly to the Paris.CFG file.

******************************************************************************

C. Common Error Messages
------------------------

Paris XP Driver Install

-  "One or more required installation files are missing."
   
   This error will occur if you try to run SETUP.EXE from the .ZIP file 
   without extracting it first under Windows XP.  Right-click the .ZIP file
   in Explorer and select "Extract All...".  You should now be able to run
   SETUP.EXE from the new folder that pops-up after the extraction is 
   complete.

Paris Application

-  "Error in initializing Paris Engine.  Error code 1/1."

   This error occurs if the Paris application is having difficulty connecting
   to the EDS card device driver (Scherzo).  Check the Device Manager to 
   verify that the OS has recognized your EDS cards and drivers.  You can 
   open the Device Manager from the "System" Control Panel applet.  There 
   should be an entry "ENSONIQ Scherzo" under the "System Devices" tree node 
   for each EDS card installed on your system.  Double-click each entry to 
   check the device status.

   To correct the problem, you can try running through the driver install 
   program again or setup the drivers using the manual install instructions
   at the end of this document.  Make sure you reboot your computer if you 
   update the drivers.  Additionally, you should make sure that your EDS 
   cards are firmly seated in their PCI slots and interconnected correctly.  

-  "Error in initializing Paris Engine.  There are not enough free resources
    available."

   This error occurs if the Paris application is having difficulty connecting
   to the Paris MIDI driver (Pthru).  Check the Device Manager to verify that 
   the OS has recognized the Paris MIDI driver.  You can open the Device 
   Manager from the "System" Control Panel applet.  There should be an
   entry "ENSONIQ Paris MIDI Driver" under the "Sound, video and game 
   controllers" tree node.

   To correct the problem, you can try running through the driver install 
   program again or setup the drivers using the manual install instructions
   at the end of this document.  Make sure you reboot your computer if you 
   update the drivers.

-  "Error in initializing Paris Engine.  No interface was connected to the
   master card.  Please make sure the cable is firmly connected and re-launch
   Paris."

   This error occurs if no interface (MEC or 442) is detected on the master
   card.  As the message states, you should make sure the cable is firmly
   attached on the interface and at the back of the master EDS card.  Also,
   make sure that the attached MEC or 442 is powered on.  If the error 
   persists, you may need to attach the interface cable to a different EDS
   (top-most instead of bottom-most EDS or vice-versa).

-  "Error in initializing Paris Engine.  Error code 18/12."

   This error sometimes occurs with the Waves 3.5 plug-ins under Paris 3.0.  
   You can try renaming or deleting the file "WaveShell.DLL" which was 
   installed by Waves.  This file should be located in the folder:
   "\Program Files\Waves\Wave Shell VST".

-  "An error occurred while reading Default Project for new project settings.
    A new empty project will be created instead.  There is not enough free
    physical memory available."

   This error occurs when the Scherzo driver is not able to allocate 
   enough memory from the OS while loading a project.  You can try 
   rebooting your computer to clear out all of the OS memory allocations.  
   If the problem persists, you could lower your disk cache settings in the 
   Paris configuration and try again.  If lowering the disk cache resolves 
   the problem but at the same time reduces your track count too much, you 
   might consider installing more RAM on your system.

******************************************************************************

D. Support
----------

-  The Paris drivers for Windows 2000 and XP are not officially supported 
   by Intelligent Devices or E-mu.  If you are having a problem that you 
   believe is not related to the drivers, then you can go through the 
   normal support channels.  You should double-check, however, that this 
   problem is reproducible using the previous drivers under Windows 98/ME.

-  Support for the new drivers is provided unofficially through the Paris
   user's newsgroup available on the Internet at: 
   http://www.greatidea.com/paris

   When posting a problem to the newsgroup, please include a detailed 
   description of your computer (motherboard/chipset, CPU, RAM, other
   PCI devices) and your Paris rig (# of EDS, MEC modules, Paris software 
   version).  

   Also, you should generate an AppMessages.TXT log of your session if 
   possible.  To do this, hold down CTRL-ALT (Paris 2.x) or CTRL-SHIFT
   (Paris 3.x) while launching the Paris application.  The AppMessages 
   window should pop-up on the screen while Paris is loading.  The file
   AppMessages.TXT will be written to the same directory as Paris.EXE
   when you shutdown Paris.

   NOTE: If you are having difficulty getting the AppMessages window to 
   come up, you can try using the Run dialog to launch Paris rather than 
   the desktop icon or Start menu link.  To do this, click "Start...Run" 
   to open the Run dialog.  Click the "Browse..." button and double-click 
   PARIS.EXE from the Paris install folder.  PARIS.EXE will typically be 
   located in "\Program Files\Ensoniq\Paris" or "\Program Files\E-mu\Paris 
   Pro" for Paris 2.x and 3.x respectively.  The path to PARIS.EXE should 
   now be entered into the Run window.  Hold down CTRL-ALT (Paris 2.x) or 
   CTRL-SHIFT (Paris 3.x) and click the OK button on the Run dialog.

   Finally, the Scherzo and Pthru drivers use the standard kernel 
   logging facility to output warnings, errors, and trace statements.  
   You can use SysInternal's DebugView application to capture this log 
   output.  This application is available as a free download at:
   http://www.sysinternals.com.  

   Additional logging output that captures the communication between the EDS 
   card and any attached peripherals such as MECs, 442s, and C16s can be 
   created by running the UartMonitor.EXE application found in the Support 
   folder of this installation.  Additional information on this utility can
   be found in the same folder.

******************************************************************************

E. Frequently Asked Questions
-----------------------------

-  Will these new drivers allows me to use the Paris hardware with
   other hard-disk recording software?

   No, the new Paris drivers are only intended to provide 2000/XP support
   for the Paris 2.x and 3.x software.  New ASIO drivers are also under
   development, however, and these will provide support for ASIO-enabled
   hard-disk recording software.  In the future, it is possible that full
   WDM Audio drivers will be written to provide support for DirectSound 
   and MME access to the Paris hardware but this support is not included
   in the current version.

-  How do I install Windows 2000 or XP on a machine that is already running
   Windows 98 or ME?

   If you are installing Windows XP or Windows 2000 for the first time on a 
   machine that is already running Paris on Windows 98 or ME, it is highly
   recommended that you preserve the existing partition and use 2000/XP in
   a multi-boot configuration.  Since the new Paris 2000/XP drivers are still 
   in a beta-testing stage they may not work properly 100% of the time, so 
   it's a good idea to have a stable configuration to fall back on.

   The following Microsoft Knowledge Base article has more information on
   setting up a multi-boot configuration with various versions of Windows:
	   	
   HOW TO: Create a Multiple-Boot System in Windows XP (Q306559)
   http://support.microsoft.com/default.aspx?scid=kb;en-us;Q306559

-  Which version of Windows XP is best for Paris: Home or Professional?

   Both Windows XP Home and Professional are suitable for use with Paris.
   For a dedicated Paris machine, you probably won't need the additional 
   features provided by Windows XP Professional unless you have a 
   multi-processor machine.  

   More information on the differences between the Home and Professional
   editions of Windows XP can be found at:
   http://www.microsoft.com/windowsxp/pro/howtobuy/choosing.asp

-  Should I use FAT32 or NTFS for my Windows disk partitions?

   Because you can easily upgrade a FAT32 partition to NTFS at a later time, 
   but you cannot revert an NTFS partition to FAT32, it is recommended that 
   you use FAT32 if you're not sure.  Also, formatting partitions with FAT32
   will allow them to be accessed from previous versions of Windows and 
   other operating systems such as Linux or BSD.

   NTFS does provide additional features over FAT32 such as better data 
   integrity, file encryption, file compression, and indexing services.
   Most of these services, however, are unnecessary for DAW applications
   and may in fact be detrimental to disk I/O performance.   

   More information on the differences between the FAT32 and NTFS file
   systems can be found at:
   http://www.anandtech.com/guides/viewfaq.html?i=63

-  Can Paris be used on a multi-processor system?

   Both Windows 2000 and Windows XP Professional include support for
   multi-processor machines.  The Paris drivers have undergone testing
   on both dual Intel Pentium and AMD Athlon configurations.

-  Will I need to upgrade my RAM to run Paris under 2000/XP?

   If you don't already have at least 256MB RAM, then you should 
   probably consider upgrading.  512MB is a solid amount and should
   be more than enough for running Paris in most cases.  

-  Will disabling ACPI in my motherboard's BIOS improve system 
   performance?  Is it OK to share IRQs between EDS cards and other 
   PCI devices?

   Some 2000/XP tweaking guides recommend that ACPI be disabled on 
   motherboards that support it to improve overall PCI bus performance.
   It's not really clear whether or not this is a measurable benefit to
   the system.  Also, disabling ACPI can interfere with power-management
   features such as automatic shutoff during shutdown and suspend/resume.  

   The Paris EDS drivers will work with both ACPI enabled and disabled.  
   If you are not having any problems with your system, it is recommended
   that you leave this feature enabled.

   With plug-and-play motherboards supporting ACPI, you may find that 
   your EDS cards share IRQs with other PCI devices.  This is normal
   behavior and the Paris EDS drivers are designed to support IRQ sharing.
   Not all devices, however, support IRQ sharing and can cause conflicts
   with the Paris EDS drivers.  If you are suffering from system crashes 
   ("blue screens"), you can try disabling unused integrated devices 
   such as USB controllers, serial ports, etc. to free up more IRQs.
   You can also use the Device Manager to create hardware profiles with
   only the necessary devices for a Paris session.
   
   More information on IRQ sharing and ACPI can be found at:
   http://www.anandtech.com/guides/viewfaq.html?i=47

   More information on setting up hardware profiles can be found at:
   HOW TO: Set Up Hardware Profiles for Laptop Computers in Windows XP
   http://support.microsoft.com/default.aspx?scid=kb;en-us;Q308577

-  What are some 2000/XP optimization tweaks that I can make to 
   improve the performance of the Paris application?

   The jury is still out on the best Windows 2000/XP settings for
   running Paris.  Most of the OS tuning advice that came with the
   Paris software does not apply to 2000/XP.  There are quite a few
   2000/XP tuning guides available on the Internet, but unfortunately 
   I cannot recommend any of them at this time.  Your best bet is to
   keep your eyes on the Paris newsgroup (and the forums for other 
   audio hardware/software you're running under 2000/XP) and see what 
   other users are saying.

-  After installing the Paris drivers, my machine is completely hosed!
   What do I do now?

   Well nobody's perfect (not even me), so these drivers may not work 
   with your machine.

   In case of a catastrophic FUBAR scenario, the following Microsoft 
   Knowledge Base article has some good tips for restoring your system 
   to a useable state:

   How to Troubleshoot Hardware and Software Driver Problems in Windows 
   XP (Q322205)
   http://support.microsoft.com/search/preview.aspx?scid=kb;en-us;Q322205

   Remember: backup is your friend!

******************************************************************************

E. File Manifest and Versions
-----------------------------

Version 3.03 (Beta 3) July 30, 2002
- First public beta release

Version 3.02 (Beta 2) July 25, 2002
- Second limited beta release

Version 3.01 (Beta 1) July 02, 2002
- Initial limited beta release

The following files should be included in the install package:

Filename                        Version   Description
--------                        -------   -----------
Setup.EXE                       3.0.3     Automated installer for drivers
Scherzo.SYS                     3.0.3     EDS-1000 device driver
Scherzo.INF                     3.0.3     EDS-1000 device driver setup info
Pthru.DRV                       3.0.3     Paris 2.x MIDI driver
Pthru.INF                       3.0.3     Paris 2.x MIDI driver setup info 
PARIS_StudioControlLibrary.DLL  3.0.3     Paris support library
PARIS_StudioControlLibrary      3.0.3     Supplemental Paris support library 
                                          wrapper for Windows 2000
UartMonitor.EXE                 3.0.3     Scherzo UART logging application

******************************************************************************

G. Manual Installation Instructions
-----------------------------------

The following are manual installation instructions for the Paris 2000/XP
drivers.  These instructions accomplish the same tasks as the automated
driver installer (SETUP.EXE) and are provided as supplement in case there
are problems with the automated installer. 

1) Install the updated Ensoniq Scherzo driver for your EDS-1000 card(s).

   -  First, you need to launch the "Add Hardware Wizard".  To do this, click
      the Start button and open the Control Panel.

      If you are using the default Control Panel view (XP only):
         a.) Select the "Printers and Other Hardware" category.
         b.) Select the "Add Hardware" link from the "See Also" section.

      If you are using the classic Control Panel view (or Windows 2000):
         a.) Select the "System" applet on the Control Panel to open the 
            "System Properties" page.
         b.) Select the "Hardware" tab and click the "Add Hardware Wizard"
            button to begin installation.  

   -  On the first screen of the "Add Hardware Wizard", click the "Next" 
      button to let the wizard examine your computer's hardware.  
      
   -  Next, the wizard will ask you if you have already connected the 
      hardware.  Select the option "Yes, I have already connected the 
      hardware" and click the "Next" button to continue.

   -  You now should be presented with a list of connected hardware devices 
      that are installed on your system.  Scroll through the list until you 
      find an entry entitled "Multimedia Audio Controller" that corresponds
      with your installed EDS-1000 card(s).  It should have a yellow 
      exclamation point next to it indicating that a driver has not yet 
      been installed for it.  Select this entry from the list and click the 
      "Next" button to continue.

   -  The wizard will now inform you that the drivers for this hardware have
      not yet been installed.  Click the "Finish" button to launch the
      hardware update wizard.

   -  On the first screen of the hardware update wizard, select the option 
      "Install from a list or specified location (Advanced)" and click the 
      "Next" button to continue.

   -  On the next screen, select the option "Don't search.  I will choose the 
      driver to install" and click the "Next" button to continue.

   -  On the next screen, you will be presented with a list of common hardware
      types.  Select "System devices" from this list.  Click the "Next" button
      to continue.

   -  On the next screen, you will be prompted to select the driver for 
      your device.  Click the "Have Disk" button.  This will display 
      the "Install From Disk" dialog.  
      
   -  On this screen click the "Browse" button and select the folder where 
      you unpacked the driver installation files.  This folder should contain 
      the "SCHERZO.INF" file.  Once you have selected the folder, click the 
      "OK" button. 

   -  If you selected the correct folder, the wizard should now display 
      "Ensoniq Scherzo" as the driver to be installed.  Click the "Next" 
      button to install the driver.

   -  You may be given a warning that the driver is not digitally signed or 
      that it has not passed Windows Logo testing.  If so, click the 
      "Continue Anyway" button to continue installation of the driver.

   -  You should now see a animated progress report as Windows installs the
      driver.  Once it has completed, click the "Finish" button to exit the 
      hardware installation wizard.  You may be prompted to restart your 
      computer.  You can either do this now, or wait until you have finished
      the rest of these installation instructions.

2.) Install the updated Ensoniq Paris MIDI driver for MTC synchronization.

   -  First, you need to launch the "Add Hardware Wizard".  To do this, click
      the Start button and open the Control Panel.

      If you are using the default Control Panel view (XP only):
         a.) Select the "Printers and Other Hardware" category.
         b.) Select the "Add Hardware" link from the "See Also" section.

      If you are using the classic Control Panel view (or Windows 2000):
         a.) Select the "System" applet on the Control Panel to open the 
            "System Properties" page.
         b.) Select the "Hardware" tab and click the "Add Hardware Wizard"
            button to begin installation.  
            
   -  On the first screen of the "Add Hardware Wizard", click the "Next" 
      button to let the wizard examine your computer's hardware.  
      
   -  Next, the wizard will ask you if you have already connected the 
      hardware.  Select the option "Yes, I have already connected the 
      hardware" and  click the "Next" button to continue.

   -  You now should be presented with a list of connected hardware devices 
      that are installed on your system.  Scroll to the bottom of this list 
      and select "Add a new hardware device".  Click the "Next" button to 
      continue.

   -  On the next screen, select the option "Install the hardware that I 
      manually select from a list (Advanced)".  Click the "Next" button to 
      continue.

   -  On the next screen, you will be presented with a list of common 
      hardware types.  Select "Sound, video, and game controllers" from this 
      list.  Click the "Next" button to continue.

   -  On the next screen, you will be prompted to select the driver for 
      your device.  Click the "Have Disk" button.  This will display 
      the "Install From Disk" dialog.  
      
   -  On this screen click the "Browse" button and select the folder where 
      you unpacked the driver installation files.  This folder should contain 
      the "PTHRU.INF" file.  Once you have selected the folder, click the 
      "OK" button. 

   -  If you selected the correct folder, the wizard should now display 
      "Ensoniq PARIS MIDI Driver" as the driver to be installed.  Click the 
      "Next" button to install the driver.

   -  You may be given a warning that the driver is not digitally signed or 
      that it has not passed Windows Logo testing.  If so, click the 
      "Continue Anyway" button to continue installation of the driver.

   -  You should now see a animated progress report as Windows installs the
      driver.  Once it has completed, click the "Finish" button to exit the 
      hardware installation wizard.  You may be prompted to restart your 
      computer.  You can either do this now, or wait until you have finished
      the rest of these installation instructions.

3) Install the updated Ensoniq Paris Studio Control Library.

   -  Copy the files PARIS_StudioControlLibrary.DLL and 
      PARIS_StudioControlLibrary from the folder containing the installation 
      files to your system folder (typically this is named "\WINNT\System32"
      or "\Windows\System32" on the drive where Windows 2000 or XP is 
      installed respectively).  

4) If you didn't reboot your computer during the installation, you should
   do so now.

******************************************************************************

H. Credits and Acknowledgements

The port of the Scherzo driver and NT-compatibility fixes to PSCL were
provided by yours truly (Chris Thoman).  The port of the Paris MIDI driver 
and numerous patches to my dodgy code were provided by Mark Woollard.

Special thanks go to:

-  Chuck Duffy for negotiating with Intelligent Devices and E-mu to get the 
   source code and distribution rights for the Paris drivers.  He was also
   brave enough to be the first guinea pig during driver testing.  Finally,
   he has provided an invaluable service to the Paris community by hosting
   the Great Idea Paris user's website and newsgroups.  Thanks Chuck!

-  Edmund Pirali at Intelligent Devices for tracking down the source code for
   various components and providing support, advice, and encouragement during 
   the driver development process.

-  Brian Tankersley for being a Paris diehard and sponsoring a massive
   driver debugging weekend on his monster rig in Nashville.  I wish I had 
   that much equipment!

-  Hillary Wilson, Scott Emmerman, Brent Elder, and others at E-mu who gave
   us permission to go ahead with this whole crazy idea.

-  And, of course, those mysterious engineers at Ensoniq who put the special
   sauce into the Paris hardware.  May your mojo live forever!

******************************************************************************